home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / ccur21b.arc / CCUR.DOC < prev   
Encoding:
Text File  |  1987-06-28  |  9.3 KB  |  203 lines
  1.                                COUNTING CURSOR
  2.                                    Rev. 2.1
  3.                       (c) 1986, 1987 by Thomas A. Lundin
  4.                              All Rights Reserved
  5.  
  6.  
  7.                                   WHAT'S NEW
  8.  
  9. 06/28/87  This update introduces a memory-resident version of CCUR named 
  10.           CCUR.COM.  (CCUR.EXE is no longer used.)
  11.  
  12.  
  13.                                   BACKGROUND
  14.  
  15. In the course of my involvement in media conversion services -- for example, 
  16. taking a 9-track magnetic tape and transferring the data onto an IBM PC 
  17. floppy -- I am often given a data base file of some kind to be processed from 
  18. a fixed-length format to comma-delimited SDF or some such type.  Usually, 
  19. these files are not accompanied by any record layout, and I previously had 
  20. resorted to calling up a portion of the file using the TYPE command (or some 
  21. screen editor) and manually counting characters to establish the layout.  
  22. Accuracy is critical, so I'd usually go through this counting procedure at 
  23. least twice until I was satisfied that the field lengths I'd come up with were 
  24. correct.  The public domain program RULER.COM had been a big help in giving me 
  25. a visual point of reference on the screen when counting across large voids of 
  26. blank spaces, so, taking the idea behind RULER a step further, I wrote 
  27. CCUR.EXE, the Counting Cursor program.
  28.  
  29. CCUR places a movable cursor on a static screen display and lets your fingers 
  30. do the walking while the cursor does the counting.  The counter can be toggled 
  31. on or off and initialized to zero or one anywhere on the screen, giving you a 
  32. quick count of the characters spanning two points.
  33.  
  34. Features of CCUR include a constantly-updated row/column coordinate readout; 
  35. the ability to jump to the top left, lower right, or center of the display, as 
  36. well as to the beginning or end of a line with a single keystroke; the ability 
  37. to skip forward or backward a specified number of characters from the current 
  38. point; the ability to write the displayed widths to a file for external 
  39. reference; and the ability to save the screen image in a disk file.  Version 
  40. 2.1 (CCUR.COM) provides the capabilities of CCUR in a memory-resident form 
  41. and adds a time/date display to the help screen.
  42.  
  43.  
  44.                                   OPERATION
  45.  
  46. Usage:
  47.      CCUR ─┘     for the memory-resident version
  48.      CCUR /n ─┘  for the non-resident version
  49.  
  50. The current display is left as-is, but a status line is displayed on line 25 
  51. of the screen.  A block cursor is positioned at the upper left corner of the 
  52. display.
  53.  
  54. MEMORY RESIDENT NOTE:
  55. Use the Shift-PrtSc combination to invoke the program at any time.  CCUR 
  56. provides its own PrtSc function in place of the one it wipes out.  To remove 
  57. CCUR from memory, you must reboot your computer. 
  58.  
  59. THE STATUS LINE:
  60. The right portion of the status line provides a readout of the current
  61. counter value (or OFF), the value offset (0 or 1), and the current cursor
  62. row/column coordinate.
  63.  
  64.      F1 - Help key
  65.      A pop-up menu will appear at the top of the screen showing a list of 
  66.      available commands and the current date and time.  Press any key to 
  67.      remove the menu and continue where you left off.  Pressing a command key 
  68.      from the help menu will execute that command immediately.
  69.  
  70.      Arrow Keys
  71.      These keys operate as you would expect them to.
  72.  
  73.      HOME key
  74.      Places the cursor at the start of the current row, updates the counter
  75.      accordingly.
  76.  
  77.      END key
  78.      Places the cursor at the end of the current row, updates the counter
  79.      accordingly.
  80.  
  81.      PgUp key
  82.      Places the cursor in the upper left screen corner, updates the counter 
  83.      accordingly.
  84.  
  85.      PgDn key
  86.      Places the cursor in the lower right screen corner, updates the counter 
  87.      accordingly.
  88.  
  89.      5 key (num pad shift 5)
  90.      Places the cursor in the middle of the display area, updates the counter
  91.      accordingly.
  92.  
  93.      Gray (-) key
  94.      Allows input of a numeric value to be subtracted from the current cursor 
  95.      location.  The cursor is positioned backward the number of characters 
  96.      specified by the value, and the counter is updated.  If the value would 
  97.      cause the cursor to be displayed past the HOME position, the operation is 
  98.      ignored.
  99.  
  100.      Gray (+) key
  101.      Allows input of a numeric value to be added to the current cursor 
  102.      location.  The cursor is positioned forward the number of characters 
  103.      specified by the value, and the counter is updated.  If the value would 
  104.      cause the cursor to be displayed past the END position, the operation is 
  105.      ignored.
  106.  
  107.      '0' (zero)
  108.      Causes the base counter and coordinate values to begin at zero.  This 
  109.      command is provided for notational convenience, as you might be 
  110.      accustomed to counting from zero.
  111.  
  112.      '1' (one)
  113.      Causes the base counter and coordinate values to begin at one.  This 
  114.      command is provided for notational convenience, as you might be 
  115.      accustomed to counting from one.
  116.  
  117.      'C'ount
  118.      If the counter is currently OFF, this command turns the counter ON and 
  119.      initializes it.  If the counter is currently ON, this command turns the 
  120.      counter OFF.  An active counter can be cleared by pressing 'C' twice.
  121.  
  122.      'W'rt
  123.      If the counter is ON, the current value in the counter display is 
  124.      recorded in memory and will be written to a disk file when the program is 
  125.      exited.  The Wrt (Write Count) command can be executed multiple times; 
  126.      each counter value recorded will be separated by a comma.  The colon 
  127.      following the word "Count" will blink to inform you that the recording 
  128.      has taken place.
  129.  
  130.      'PrtSc' (unshifted PrtSc)
  131.      The current screen image will be sent to the printer or to a disk file.  
  132.      If no file name is provided at the prompt, the printer is used.  Each 
  133.      saved screen line is terminated by a carriage return/line feed 
  134.      combination and trailing blanks at the end of screen lines are removed.  
  135.      This Print Screen routine is much faster than the one provided by DOS.
  136.  
  137.      ESC key or 'Q'
  138.      Exits back to DOS in the stand-alone version or exits back to the 
  139.      suspended application in the memory-resident version.  If the Wrt command 
  140.      was used, the saved data will be sent to the printer or to a disk file 
  141.      before exiting.  If no file name is provided at the prompt, the printer 
  142.      is used.
  143.  
  144.  
  145.                                     
  146.                                     NOTES 
  147.  
  148. PROGRAM INFORMATION:
  149. CCUR was written in Lattice C, v 3.1.  Screen I/O routines were adapted for 
  150. use from JCLIB.C by Dr. Jim Conn.  The low-level TSR functions were provided 
  151. by John Riley of Lattice Inc.
  152.  
  153. SYSTEM REQUIREMENTS:
  154. IBM PC or compatible, 128K memory, DOS 2.x or 3.x.  The memory-resident 
  155. version eats up about 22K of RAM.  (Warning: If you call CCUR from the DOS 
  156. prompt more than once, it will load itself again and eat up another 22K.)
  157.  
  158. DISCLAIMER:
  159. This program is provided as-is.  It has been tested on an IBM PC, American/AT, 
  160. Leading Edge Model D, NEC APC III, and a Super/XT, and has been found to be 
  161. stable on these machines even when running other TSR programs (including 
  162. DoubleDOS), and yet: It may not do what you want it to do, and it may not work 
  163. on your particular clone or compatible.  You will assume all risk of use.
  164.  
  165. LICENSE:
  166. You may copy this program all you want.  Share it.  Upload it.  Use it.  Don't 
  167. charge any money for its distribution or use, unless a portion of what you 
  168. charge is contributed to me.  Also, don't integrate this program with any 
  169. other program or commercial service and try to claim it's your property; 
  170. that's unethical and dishonorable.
  171.  
  172. BUG FIXES/ENHANCEMENTS:
  173. Ver. 1.1:      Minor bug in Wrt command corrected to now record the displayed
  174.                value of the counter, as opposed to the zero offset value.
  175. Ver. 1.2:      Screen save operation is instantaneous now, thanks to improved 
  176.                BIOS support in Lattice C 3.1.
  177. Ver. 2.0:      Added a separate pop-up help screen.  Changed the file 
  178.                interface somewhat.  Also implemented a long-awaited 
  179.                memory-resident version.
  180. Ver. 2.1:      Correctly set original cursor type & position on exit; added 
  181.                time/date display to help menu; integrated resident and 
  182.                non-resident programs in one.  
  183.  
  184. FINALLY:
  185. If you find this program to be of value, contributions in any amount ($10 
  186. suggested) will be gratefully accepted.  All contributors will be mailed the 
  187. latest version of the program as it becomes available and their suggestions 
  188. will have priority consideration for subsequent releases.  Contributors who 
  189. donate $25 or more will also receive a bonus diskette of productivity aids I 
  190. have developed and found useful in my work.
  191.  
  192. Send comments/bug reports/contributions to:
  193.  
  194.                          ╔══════════════════════════╗
  195.                          ║     Thomas A. Lundin     ║
  196.                          ║ Graphics Unlimited, Inc. ║
  197.                          ║ 3000 Second Street North ║
  198.                          ║  Minneapolis, MN  55411  ║
  199.                          ║      (612) 588-7571      ║
  200.                          ╚══════════════════════════╝
  201.  
  202. Thank you for using CCUR.
  203.